transpose
Type
function
Summary
Returns a two-dimensional array after swapping the order of keys for each element of the array.
Syntax
transpose(<array>)
Description
Use the transpose function to swap rows and columns in a matrix.
A two-dimensional array is an array whose elements have a two-part key to describe them. You can visualize such an array as a set of rows and columns:the first part of each element's key is the row number, and the second part is the column number. For example, the expression myArray[3,2] describes the element of myArray which is in the third row, second column.
The transpose function simply swaps rows for columns. In other words, for each element in the array, the corresponding element in transpose(array) has its two parts switched one for the other. The value in the third row, second column is moved to the second row, third column.
The transpose function is its own inverse : you can transpose a transposed array again to recover the original array.
If the array has missing elements, the transpose function will fail to work. For example, an array that contains elements myArray[1,1], myArray[1,2], and myArray[2,2] cannot be transposed because the element myArray[2,1] a/is missing.
Parameters
| Name | Type | Description |
|---|---|---|
array | array | A two-dimensional array variable whose elements are numbers, and whose keys are sequential numbers. |
Examples
transpose(myArray)
put transpose(censusByHousehold) into censusByGroup
Related
control structure: function
function: keys, transpose, matrixMultiply
glossary: array, return, element
Compatibility and Support
Introduced
LiveCode 1.1
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile